home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / win / vb / graf_st.exe / GRAFSTAT.TXT < prev    next >
Encoding:
Text File  |  1991-12-02  |  6.4 KB  |  139 lines
  1. -------------------------------------------------------------------------------
  2.  
  3.                                    GRAFSTAT
  4.                       Graphical Status Control version 1.0
  5.                  Copyright (c) 1991 by Object Productivity, Inc.
  6.  
  7. ===============================================================================
  8.  
  9.  
  10. PURPOSE...
  11.  
  12. GrafStat is a custom control that displays a graphical gauge representing the
  13. status of a given process.  Currently, GrafStat can emulate one general type
  14. of gauge, the indicator.  The indicator linearly represents an integer 
  15. magnitude within a given range by displaying, graphically, it's current value.
  16. The indicator provides two styles, thermometer and needle.  The thermometer
  17. style represents process-status' as a partially "filled" value-region within 
  18. a rectangular area.  The needle style similarly represents process-status', 
  19. except that the value region (including and previous to the value mark) is 
  20. not filled.  All GrafStat styles allow the customization of their appearance 
  21. and function (e.g. display value or percent text, changing colors, orientation,
  22. etc.).  In the future, GrafStat will be extended to emulate several additional
  23. types of gauges and many different styles.  Currently, GrafStat is simple, yet
  24. is valuable in uses such as file-transfer, installation, data-acquisition, 
  25. performance analysis, and compression, to name a few.
  26.  
  27.  
  28. FUNCTION...
  29.  
  30. The GrafStat control has 3 general areas of functionality, namely, setting 
  31. the style, setting the range, and setting the current value (position).  
  32. Currently, the GrafStat control supports the two basic styles mentioned 
  33. above (i.e. therm., needle), with additional options to effect the orientation 
  34. of the control and the display of a current value.  When the GrafStat control 
  35. is first created via CreateWindow, or instantiated via a dialog template, it's 
  36. default appearance is a rectangle with a white background, red foreground, and 
  37. thermometer style with percent status of 0% out of a range of 100.  When using 
  38. a dialog or form editor, the user can move and resize this control to any 
  39. rectangular size.  Additionally, the user can set the style of the control 
  40. to an indicator type of thermometer or needle, orientation of vertical or 
  41. horizontal, aspect of percent or value, progress of fill-right/down, 
  42. fill-left/up, empty-right/down, or fill-left-up, and toggle the display of the 
  43. current value to display or no display.  After a GrafStat control has been 
  44. created via a dialog or the CreateWindow function, the developer can 
  45. manipulate the control via messages as described bellow.  Please see the 
  46. demonstration application GSDEMO.EXE for a "look-and-feel" of the 
  47. functionality of GrafStat.
  48.  
  49.  
  50. MESSAGES...
  51.  
  52. The following messages allow the developer to manipulate an instance of a 
  53. GrafStat control by sending messages via the SendMessage function.  Each 
  54. message is listed with a description of the word-parameter (wParam).  The long
  55. parameter (lParam) is not used in any of these messages.  See your SDK or 
  56. Windows reference for more information on this or related topics.
  57.  
  58. GSM_SETSTYLE           Set the style of the grafstat control, wParam=style.
  59.             The style can include any combination of styles, one
  60.             from each line,
  61.  
  62.                 GSS_THERMOMETER or GSS_NEEDLE
  63.                 GSS_HORIZONTAL or GSS_VERTICAL
  64.                 GSS_PERCENT or  GSS_VALUE
  65.                 GSS_TEXT or GSS_NOTEXT
  66.                 GSS_FILL or GSS_EMPTY
  67.                 GSS_RIGHTDOWN or GSS_LEFTUP
  68.  
  69.             See the demonstration source-code and executable for
  70.             examples of these styles and their appearance.
  71.  
  72. GSM_SETRANGE        Set the range of the grafstat control, wParam=integer-
  73.             range (not int type).
  74.  
  75. GSM_SETPOSITION        Set the position of the grafstat control,
  76.             wParam=integer-position (not int type).
  77.  
  78. GSM_DELTAPOSITION    Add to the current position, wParam=integer-delta
  79.             (value to add to current position).
  80.  
  81. GSM_SETFORGCOLOR    Set the foreground (indicator) color, wParam=CREF
  82.             (rgb value, see your SDK).
  83.  
  84. GSM_SETBACKCOLOR    Set the background color, wParam=CREF (rgb value).
  85.  
  86.  
  87. -------------------------------------------------------------------------------
  88.  (see order.txt for info. on obtaining the grafstat custom control & source)
  89.  
  90.  
  91.          ----------------end-of-author's-documentation---------------
  92.  
  93.                          Software Library Information:
  94.  
  95.                     This disk copy provided as a service of
  96.  
  97.                            Public (software) Library
  98.  
  99.          We are not the authors of this program, nor are we associated
  100.          with the author in any way other than as a distributor of the
  101.          program in accordance with the author's terms of distribution.
  102.  
  103.          Please direct shareware payments and specific questions about
  104.          this program to the author of the program, whose name appears
  105.          elsewhere in  this documentation. If you have trouble getting
  106.          in touch with the author,  we will do whatever we can to help
  107.          you with your questions. All programs have been tested and do
  108.          run.  To report problems,  please use the form that is in the
  109.          file PROBLEM.DOC on many of our disks or in other written for-
  110.          mat with screen printouts, if possible.  PsL cannot debug pro-
  111.          programs over the telephone, though we can answer questions.
  112.  
  113.          Disks in the PsL are updated  monthly,  so if you did not get
  114.          this disk directly from the PsL, you should be aware that the
  115.          files in this set may no longer be the current versions. Also,
  116.          if you got this disk from another vendor and are having prob-
  117.          lems,  be aware that  some files may have become corrupted or
  118.          lost by that vendor. Get a current, working disk from PsL.
  119.  
  120.          For a copy of the latest monthly software library newsletter
  121.          and a list of the 3,000+ disks in the library, call or write
  122.  
  123.                            Public (software) Library
  124.                                P.O.Box 35705 - F
  125.                             Houston, TX 77235-5705
  126.  
  127.                                  Orders only:
  128.                                 1-800-2424-PSL
  129.                               MC/Visa/AmEx/Discover
  130.  
  131.                           Outside of U.S. or in Texas
  132.                           or for general information,
  133.                               Call 1-713-524-6394
  134.  
  135.                           PsL also has an outstanding
  136.                           catalog for the Macintosh.
  137.  
  138.  
  139.